Previous Topic

Next Topic

Configuring the QAWORLD.INI file for QAS Batch

You must manually edit various sections in the QAWORLD.INI file for QAS Batch v4 to ensure that QAS Batch functions correctly when used with iMIS.

To define country address layouts if you have a QuickAddress Pro license

QAS Batch does not have a visual interface for defining country address layouts. The easiest way to ensure that QAS Batch has the correct country address layouts to work properly with iMIS is to use the following procedure, which assumes that you also have a QuickAddress Pro license. If you do not have a QuickAddress Pro license, you should adapt this procedure as necessary to manually configure your QAWORLD.INI file.

  1. Use the QuickAddress Pro Configuration Editor to define the country address layout for each country address database, as described in the following sections:
  2. Open the QAWSERVE.INI file that is located in your QuickAddress Pro API folder.
  3. For each country address layout that you have defined, locate the corresponding AddressLineCount, DataplusLines, and AddressLinen settings and copy them to the Windows clipboard.

    For example, if your address layout for New Zealand has six lines, you would copy the following settings from the QAWSERVE.INI file:

    NZLAddressLineCount=6
    NZLDataplusLines=0
    NZLAddressLine1=W40
    NZLAddressLine2=W40
    NZLAddressLine3=W40
    NZLAddressLine4=W40,L21
    NZLAddressLine5=W15
    NZLAddressLine6=W10,C11
  4. Paste the copied settings into the appropriate section of the QAWORLD.INI file that is located in your QuickAddress Batch API folder.

    In most cases, you will be replacing existing settings that have different values, so you must carefully examine the contents of your QAWORLD.INI file and ensure that you have completely replaced the appropriate settings with the values copied from the QAWSERVE.INI file from QuickAddress Pro.

  5. Delete the three-letter country prefix located at the beginning of each line that you pasted into the QAWORLD.INI file.

    For example, if you pasted the lines corresponding to the address layout for New Zealand, you would edit the pasted lines to look like the following:

    AddressLineCount=6
    DataplusLines=0
    AddressLine1=W40
    AddressLine2=W40
    AddressLine3=W40
    AddressLine4=W40,L21
    AddressLine5=W15
    AddressLine6=W10,C11

To ensure proper behavior when multiple country address databases are used with iMIS

Each country section of the QAWORLD.INI file in the QAS Batch API folder must have a CountryBase setting that first specifies the current country section label, followed by the labels of all other country sections in the file.

For example, if you have three country databases, Australia, United Kingdom, and New Zealand, their respective CountryBase settings must have the following content:

[AUS]
CountryBase=AUS GBR NZL
...rest of the settings for AUS

[GBR]
CountryBase=GBR AUS NZL
...rest of the settings for GBR

[NZL]
CountryBase=NZL AUS GBR
...rest of the settings for NZL

If your CountryBase settings are not formatted in this manner, then iMIS will verify a batch of addresses only against the default country database that is specified in the Customer Setup - QAS Options dialog (see New QAS options on the Customer Setup window for details).

Note: If the United Kingdom (GBR) is one of your multiple country databases, you might encounter errors with the State code of your non-UK addresses being changed from an abbreviated format to a fully-spelled-out format if you select GBR as your default country database for the batch run. This happens because QAS Batch v4 applies the address formatting for the default country to all addresses processed in the batch, regardless of the individual CountryBase settings for each country. To prevent this problem from affecting your iMIS addresses, you can (a) select a country other than GBR as the default country database before running a QAS Batch job, or (b) edit the [GBR] section of your QAWORLD.INI file to remove the PNR County value (L12) from the format for AddressLine5, like this: AddressLine5=W15,L11.

To prevent API calls not being directed to the correct system path

API calls from iMIS to QAS Batch can sometimes fail, due to a known "inconsistency" with QAS Batch. Adding a homedir setting to your QAWORLD.INI file for QAS Batch prevents this problem from occurring.

  1. Open the QAWORLD.INI file that is located in your QuickAddress Batch API folder.
  2. In the [QADEFAULT] section of the file, add a homedir setting that specifies the full path to your QuickAddress Batch API folder.

    The path that you specify can be formatted as a local file path on the iMIS client's computer (for example, C:\Program Files\QAS\QuickAddress Pro API), or it can be formatted as a UNC to a network computer (for example, \\atcserv\C\Program Files\QAS\QuickAddress Batch API).

    For example, if your QuickAddress Batch API folder is located in C:\Program Files\QAS, you would use the following homedir setting:

    [QADefault]

    homedir=C:\Program Files\QAS\QuickAddress Batch API
    ...rest of the settings for QADefault

See Also

Implementing QAS with iMIS

Limitations and interaction with AccuMail

Installing QAS Pro v4 and QAS Batch v4

Configuring QAS Address and Data Plus formats

Specifying QAS API install paths

Specifying the default country database for QAS

Enabling or disabling address auto-verification for QAS


ASI logo 10.6 Production Release. Updated 3/7/2006 3:17:56 PM
© Copyright by Advanced Solutions International, Inc. All rights reserved.